This guide explains how to white label Itential Automation Platform (IAP) with a custom CSS template. The steps outlined in this article will override the default Itential theme.
Requirements
The following items are required.
- File system access to IAP.
- The primary hex color code for your organization, e.g.,
#7ab27f
. - Company logo for the IAP Log In page.
- Company logo for the IAP header.
The IAP Log In page company logo must meet the following requirements.
Requirement | Value |
---|---|
File Format | PNG |
File Name | logo.png |
Dimensions (px) | 256x256 |
Background | transparent |
The IAP header company logo must meet the following requirements.
Requirement | Value |
---|---|
File Format | PNG |
File Name | logo-wide.png |
Dimensions (px) | 40x100 |
Background | transparent |
Steps
Perform the following steps to white label the user interface of IAP with your custom colors and logo.
Navigate to the UI style direction of IAP.
cd ./node-modules/@itential/pronghorn-core/us/style
Edit the
custom.css
file.Note: The constants of
custom.css
have been commented out, so as to not affect the system when not in use.Locate the
\*\*\* SECTION HEADER \*\*\*
heading in each section of the file.Remove the comments below each heading by removing the slash and asterisk at the start,
/*
, and end,*/
,of each section.Replace the example hex color codes with the color codes for your company's brand throughout the file.
- Primary Color:
#7ab27f
(example code)
- Primary Color:
Replace the temporary logos with your company branded logos.
The company logo for login may be found at the following location.
node_modules/@itential/pronghorn-core/ui/custom/logo.png
The header logo may be found at the following location.
node_modules/@itential/pronghorn-core/ui/custom/logo-wide.png
Once all steps are complete, the IAP system will be customized to display your company logo and colors.